Copyright: Copyright © 1995 Win Novation Informatique


Ouvrir Fichier
Ouvrir un fichier

Ce dialogue permet de sélectionner un fichier


Dialogue sauver fichier
Sauver fichier

Ce dialogue permet de sauver un fichier


Futures Extensions

Si ce programme rencontre du succès, des améliorations et des nouvelles options sont prévues:

- génération contextuelle pour Visual Basic
- génération contextuelle pour BC4++
- saut inter fichier HLP
- définition de macro
- Prévisualisation
- Importation, Exportation de fichier RTF
- Meilleur éditeur
- Définition de chaine de texte globale

et vos idées.............................


Choix compilateur
Choix d'un compilateur d'aide

Par défaut le compilateur d'aide est hc31.exe de Microsoft, il peut ètre remplacer par d'autres compilateurs (HCP.EXE de Microsoft) en éditant le fichier hcmak.pif avec le programme pifedit livré avec Windows


Comment mettre à jour les références

Les références sont lues du fichier .HM, il faut donc que ce fichier .HM existe.

Création Fichier .HM

Ce fichier peut être crée :

- à la main
- automatiquement avec des projets Visual C++ ou Visual Basic.

Visual C++

Il faut:

1- Indiquer dans "Options/Projet" un projet de type Visual C++
2- Dans "Options/Visual C++" cocher la case qui autorise les modifications de liens
3- Choisir le choix "Fabrique\Fabrique Visual Include HM"
4- Maintenant le fichier .HM est crée mais les nouvelles références ne sont pas automatiquement mises à jour dans la liste (pour éviter les erreurs en cas de destruction ou perte d'ID involontairement), pour cela il faut retourner dans  "Options/Visual C++" et faire "OK".

Visual Basic

Il faut:

1- Indiquer dans "OPTIONS/PROJET" un projet de type Visual Basic
2- Dans "OPTIONS/VISUAL BASIC" cocher la case qui autorise les modifications de liens
3- Choisir le choix "Fabrique\Fabrique Visual Include HM"
4- Maintenant le fichier .HM est crée mais les nouvelles références ne sont pas automatiquement mises à jour dans la liste (pour éviter les erreurs en cas de destruction ou perte d'ID involontairement), pour cela il faut retourner dans  "OPTIONS/VISUAL BASIC" et faire "OK".


Comment faire une aide C++
Fabriquer une Aide Visual C++

Première Etape

-Création du fichier Aide en entrant avec un nouveau document ou un document vide
-Dans le menu Options/Projet:
Absolument Obligatoire:
-rentrer le nom du projet (nom du future .HLP)
-choisir le repertoire de travail (pour les fichiers .RTF, .HPJ et .HM)

2° Etape(Optionnelle)

Si l'aide n'est pas liée à un projet VisualC++, cette étape est à sauter

Il faut spécifier les options de lien avec le projet visual C++. Pour cela il faut aller dans le menu "Options/VisualC++".
Il faut d'abord sélectionner le fichier resource.h utilisé par AppStudio.
Puis aller chercher dans les repertoires MFC (dans MSVC\MFC\INCLUDE) le fichier afxhelp.hm qui contient la description de tous les identificateurs des MFC.
Pour autoriser la création du fichier .hm et il est nécessaire de cocher la première check box :"Autorise Modification des liens avec Visual C++". Une fois que l'opération de création du .hm est terminée, il est préférable de retirer cette option afin de bloquer toutes modifications des liens par erreur.

Voir Dialogue des options C++

3° Etape

Il faut maintenant effectuer la saisie de l'aide au moyen de l'éditeur. La liste de gauche contient les pages d'aides, la liste de droite contient les paragraphes pour chaque page séléctionnée.

Voir Exemple Type

 Comment mettre à jour les références


Comment faire une aide Visual Basic
Fabriquer une Aide Visual Basic

Cette nouvelle version permet de gérer de façon automatique une aide pour un projet Visual Basic.

Utilisation du générateur Automatique

Un générateur de squelette d'aide existe dans cette version. Il permet à partir d'un projet Visual Basic existant de fabriquer la maximum de ce qui toujours fait à la main.

Voir Générateur automatique

Projet Visual Basic Normal

Un projet Visual Basic est désormais traité de la même façon qu'un programme Visual C++.
Un analyseur de projet Visual Basic examine les feuilles et controles et extrait les champs HelpContextID différents de 0 pour créer un fichier .HM qui contient les réfrérences qui permettent de lier un topic (ou groupe) et à un contrôle (ou feuille) spécifique.

Voir aussi Exemple Visual Basic

 Comment mettre à jour les références


Dialogue Texte Global
Texte global

Ce dialogue permet de préciser les chaines de caractères qui seront traitées dans tous les groupes (topics). Ces chaines de caractères peuvent déclencher une action comme les sujets de type SAUT.

Pour plus d'informatiions, cliquez sur la zone qui vous intéresse.


"Chaine globale": saisie de la chaine à traiter
"Distingue Maj/min": si cochée le programme distingue Majuscules et minuscules pour reconnaitre la chaine.
"Couleur courante": si cochée la couleur d'affichage de la chaine sera celle du paragraphe qui la contient (sinon c'est la couleur définie pour le lien de type "SAUT")


Les touches Ajouter/Modifier/Supprimer permet d'ajouter les chaines dans la liste. Quand on modifie la chaine sélectionnée dans la liste, il ne suffit pas de modifier la chaine ou de cocher, il faut aussi appuyer sur MODIFIER pour valider la modification


Dialogue About
A propos de ...

Win Novation Informatique
1107 Av. Jacques Cartier
44811 St Herblain Cedex 01
Tél (16) 40 43 58 18 - Fax (16) 51 80 78 23
Compuserve ID : 100 410,745

Ce fichier d'aide a été réalisé
grâce au ShareWare MakHlp

 Index principal


Echange de Sujets

Permet de copier des sujets entre groupes (topics)

Pour plus d'informatiions, cliquez sur la zone qui vous intéresse.


Dialogue choix du type
Choix du type de sujet

Pour plus d'informatiions, cliquez sur la zone qui vous intéresse.


Dialogue Edition Groupe
Edition d'un groupe

Pour plus d'informatiions, cliquez sur la zone qui vous intéresse.


Dialogue Double ID VB
Recherche double dans ID

Ce dialogue permet de visualiser les indentificateurs qui sont en doubles dans les fichiers .FRM des sources Visual Basic. Il est en effect possible que 2 controles aient la même aide.


Dialogue attributs
Configuration de fenêtre

Ce dialogue permet de préciser les attributs de placement et de couleur des fenêtres.

Pour plus d'informatiions, cliquez sur la zone qui vous intéresse.


Dialogue Choix classe VBX
Sélection de classe pour VBX

Utilité:

Ce dialogue permet de sélectionner un fichier .VBX afin de générer automatiquement un fichier d'aide .HLP pour ce controle.

Comment générer une aide VBX:

1) Chosir un fichier .VBX en appuyant sur Bouton "CHOIX VBX"
2) Sélectionner les classes désirées en les passant dans la colonne de droite
3) Eventuellement redéfinir les préfixes qui seront utilisés par la suite("DEFINITION PREFIX")
4) Générer l'application en appuyant sur le bouton "LANCE CREATION"


NomFenetre
Nom Fenêtre

Pour la fenêtre principale, il faut définir une fenêtre appelée obligatoirement "Main".

Note : Si vous utilisez une fenêtre pricipale "main" c'est le titre indiqué ici qui sera utilisé.


Caption

Le titre qui sera affiché en haut de la fenêtre.


Maximize

Fait apparaître la fenêtre plein écran


TopMost
Toujours visible

La fenêtre apparaît comme une topmost windows.
C'est à dire la fenêtre est toujours active (devant les autres).


Couleur fenêtre

Permet de spécifier une couleur pour le fond de la fenêtre.
La case de validation permet de dire au compilateur d'utilliser la couleur par défaut.


Couleur région non Scroll

Permet de spécifier une couleur pour la zone non scroll de la fenêtre (parti non mobile).
La case de validation permet de dire au compilateur d'utilliser la couleur par défaut.


Position Fenêtre
Valide fenêtre

Permet de spécifier une position et une taille pour la fenêtre.
La case de validation permet de dire au compilateur d'utilliser les attributs par défaut.

Valeur maximum de Largeur et hauteur est de 1024 (Si X = 0 et Y = 0)


Liste des noms de fenêtres
Liste des noms de fenêtre

C'est la liste de nom de fenêtre que vous avez crée.


Ajouter / Nouveau / Modifier / Supprimer

Nouveau	: permet d'initialiser les champs Caption, Nom fenêtre etc.
Ajouter	: permet d'ajouter la nouvelle fenêtre dans la liste
Modifier	: permet de valider les modifications apporté à une fenêtre
Supprimer	: permet de supprimer le nom de fenêtre sélectionné


Sujet de type Titre

Choisi un texte de type TITRE.

(Le nom et la taille de la police utilisé pour le texte est celle qui a été défini par defaut dans Options/Général)


Sujet de type Sous-Titre

Choisi un texte de type Sous TITRE.

(Le nom et la taille de la police utilisé pour le texte est celle qui a été défini par defaut dans Options/Général)


Sujet de type Texte Indenté

Choisi un texte de type texte indenté.

(Le nom et la taille de la police utilisé pour le texte est celle qui a été défini par defaut dans Options/Général)


Sujet de type Texte

Choisi un texte de type texte.

(Le nom et la taille de la police utilisé pour le texte est celle qui a été défini par defaut dans Options/Général)


Sujet de Type Saut

Choisi un texte qui va servir pour déclencher:
- un saut vers un autre groupe
- un son (en indiquant .WAV)
- ouverture de fenêtre Popup
- imptimer la feuille
- quitter
- éxecuter un programme

(Le nom et la taille de la police utilisée pour le texte est celle qui a été défini par defaut dans Options/Général)


Sujet de type Texte-Image

Choisi une image plus un texte éventuel. En cliquant sur l'image, on peut déclencher:
- un saut vers un autre groupe
- un son (en indiquant .WAV)
- ouverture de fenêtre Popup
- imprimer la feuille
- quitter
- éxecuter un programme

(Le nom et la taille de la police utilisée pour le texte est celle qui a été défini par defaut dans Options/Général)


Nom de topic
Nom

Le Champ "Nom" permet de spécifier le nom du groupe,
c'est un nom interne qui apparaitra unique dans les Combo Box de lien.
Seuls les caractères entre a et z sont autorisés


Titre Topic
Titre

Le champ "Titre" désigne le titre qui sera affiché pour le groupe
dans la boite de recherche de l'aide dans WinHelp.exe


Topic reference
Références liées au groupe

Un groupe peut être lié à une ou plusieurs références.

Supprimer un lien avec une référence :
- sélectionner la référence puis cliquez sur SUPPRIMER
Lier le groupe à une référence :
- sélectionner la référence dans la liste de haut puis cliquez sur AJOUTER


Topic Chapitre
Chapitre

Permet de classer le(s) groupe(s) dans des chapitres differents.
Elle est utile et facilite le travail, mais elle n'a aucun effet sur le fichier .HLP.


Topic Mot Clef
Mots Clefs

Les mots clefs sont ceux reconnus par winhelp.exe.
Quand on effectue une recherche, ils permettent de rechercher
un sujet bien spécial dans un fichier d'aide (.HLP).
Il est possible de rentrer plusieurs mots clefs par groupe.


TopicLstReference
Références

Liste des références disponibles.
Permet de lier le groupe à un identificateur contextuel (menu, dialogue, fenêtre ...)


Titre, Sous Titre, Texte et Texte Indenté
Edition du sujet
Types : Titres, Sous Titre, Texte et Texte indenté

Ce dialogue permet d'éditer un paragraphe d'une page.
Il est possible de spécifier un alignement, les couleurs et les diverses marges.

Pour plus d'informatiions, cliquez sur la zone qui vous intéresse.


Texte Image
Edition du sujet
Types : TexteImage

Ce dialogue permet d'éditer un paragraphe d'une page.Il est possible de spécifier un alignement, les couleurs et les diverses marges ainsi que le type de lien : Saut, Popup Son etc.

Pour plus d'informatiions, cliquez sur la zone qui vous intéresse.


DialSujetAligner
Alignement

L'alignement possible est : gauche, droite et centré


DialSujetTexteIndente
Retrait 1° ligne

Elle donne le décalage de la première ligne d'un paragraphe par rapport aux lignes suivantes.


DialSujetMarge
Marge

gauche : marge du paragraphe à gauche

droite : marge du paragraphe à droite

haut : marge du paragraphe avant le paragraphe

bas : marge du paragraphe après le paragraphe


DialSujetChoixCoche
Fin Paragraphe : elle indique la fin du paragraphe, sinon les descriptifs suivants seront sur la même ligne.

Style défaut : après une fin de paragraphe, il restitue le style par défaut pour les alignements

Non Scroll :  il crée une région fixe en haut de la page, attention, seuls les premiers descriptifs ont le droit d'avoir cette propriété.

Bar Verticale : il crée une barre verticale le long du paragraphe

Cadre : il crée un cadre autour du paragraphe

Fixe : il crée un paragraphe qui ne sera pas diminué en largeur en même temps que la fenêtre d'aide. Dans certains cas, il faudra utiliser les scrollBar pour voir la fin d'une ligne.


DialSujetRapCoul
Rappel de la couleur utilisé pour le texte actuel.


DialSujetStyle
Bouton Style

Permet de modifier la police et la couleur du texte.
(Elle n'affecte pas ceux qui sont par defauts).


DialSujetImageLigne
Image à droite et Image sur Ligne :

Les Check Box "Image à droite" et "Image sur ligne" sont d'un emploi plus subtile.

Image à droite : permet de définir une bitmap utilisée avec le texte à droite de la bitmap, un résultat semblable peut parfois ètre obtenu en ne cochant pas cette case mais en choisissant un alignement à droite.

Image sur ligne : permet de déclarer une bitmap qui sera interprétée comme un caractère d'un texte. Ce qui signifie qu'elle sera alignée sur la ligne basse du texte. Quand cette case n'est pas cochée il est possible de placer un texte le long d'une bitmap sur plusieurs lignes. Dans le cas contraire (cad cochée) une seule ligne est possible.

Attention une bitmap d'alignement centré est automatiquement de type image sur ligne


Edition sujet Saut
Edition du sujet
Types : Saut

Ce dialogue permet d'éditer un paragraphe d'une page.Il est possible de spécifier un alignement, les couleurs et les diverses marges ainsi que le type de lien : Saut, Popup Son etc.

Pour plus d'informatiions, cliquez sur la zone qui vous intéresse.


Type du Lien

Permet de choisir parmi une liste une action quand on clique sur :
- sur la BitMap si le sujet est de type ImageTexte
- sur le texte si le sujet est de type Saut.

Pour plus d'informatiions, cliquez sur la zone qui vous intéresse.


Action Saut
Saut

Il faut spécifier le nom du groupe vers lequel on saute, pour cela on le sélectionne dans la combo box juste au dessus.


Action Son
Son

Permet de jouer un fichier .WAV

Le champ présenté dans la figure ci-dessus apparait en haut de la boîte de dialogue, pour permetre de spécifier le nom du fichier .WAV
En cliquant sur [image] une boite de dialogue s'ouvre pour pouvoir sélectionner un fichier.


Action Popup
Popup

Permet l' ouverture d'une fenêtre comme celle-ci (en déclenchant bien sur un saut vers le groupe dont le nom spécifié dans la case juste au dessus de "choix du lien")


Action Imprime
Imprime

Permet d'imprimer la feuille de l'aide présente à l'écran.


Action Quitte
Quitter

Permet de quitter (fermer) le fichier .HLP


Action Execute
Execute

Permet d'éxecuter un programme spécifier (Voir figure ci-dessous).

Dans cette exemple, on éxecute le programme "WINHELP" pour afficher le fichier "CATALOG.HLP"


ChoixFichierBMPWAV
En cliquant sur [image] une boite de dialogue s'ouvre pour pouvoir sélectionner un fichier.


ChoixWindow
Choix Window (Fenêtre)

Permet de spécifier dans quel fenêtre le groupe que vous appelez sera affiché.

C'est la liste des fenêtre que vous avez crée dans "Projet/Fenêtres".

Par defaut c'est la fenêtre principal.


EchangeAjoutSelect
>>>

Permet de copier les sujets sélectionnés du groupe source vers le groupe destination.

Les sujets copiés sont ajouter à la suite des sujets éxistants dans le groupe destination.


EchangeAjoutTout
>> Tout >>

Permet de copier tout les sujets du groupe source vers le groupe destination.

Les sujets copiés sont ajouter à la suite des sujets éxistants dans le groupe destination.


EchangeInserSelect
Insèrer

Permet d'insèrer les sujets sélectionnés du groupe source vers le groupe destination.

Avant de déclencher l'action "Insèrer", vous indiquez l'emplacement de l'insertion dans la liste des sujets du groupe destination.


EchangeLstGroupe
Source / Destination

Permet de sélectionner le groupe Source ou le groupe Destination.


EchangeLstSujet
C'est la liste des sujets du groupe SOURCE

Pour sélectionner un ou plusieurs sujets, il suffit de cliquer dessus.


EchangeLstSujetDest
C'est la liste des sujets du groupe DESTINATION

Dans le cas d'une action "Insèrer", vous devez désigner la ligne d'insertion en cliquant dessus.


TextParDefaut
C'est la zone de saisie

Remarque : le texte par defaut est un texte non utilisé dans le fichier .HLP


Options Generales
Options Générales

Cette boite de dialogue permet de définir les marges par défauts des principaux paragraphes (types de sujets).
Ces valeurs sont sauvées dans le .ini du programme. Toute modification dans ce fichier peut ètre fatale à l'application.
Dans ce cas extrême, il faut effacer les lignes suspectes ou tout le fichier


Dialogue option pour VB
Options/Visual Basic

Ce dialogue permet de préciser 3 options pour la gestion d'un projet Visual Basic

Pour plus d'informatiions, cliquez sur la zone qui vous intéresse.


AutorizeLienVB
Autorise modification liens Visual Basic: permet d'autoriser ou de bloquer la création du fichier .HM quand on demande "Fabrique tout". De cette manière le fichier .HM n'est pas constamment recréé.


FabriqueTexteVB
Fabrique index texte:permet de créer un fichier .IND qui contient tous les mots reconnus par le fichier hlp.


AvantEfacementVB
Permet ou interdit d'effacer une référence déclarée dans un groupe (topic) et n'existant pas dans le fichier .HM. Cette case permet d'éviter un effacement des références involontairement en raison d'un fichier temporairement mal construit ou effacé ( ou projet déplacé)


AvantEfacementVC
A chaque fois que l'on quitte les dialogues "Options/ Projets" et "Options/ Visual C++", le xxx.hm est analysé. Si des HID_ utilisé dans l'aide ne sont plus dans les fichiers includes, une destruction des liens inutiles est engagés.
Mais avant la destruction des liens un fenêtre promt peut annuler cette destruction.
En effet, il suffit de détruire par erreur le fichier xxx.hm pour qu'immédiatement tous les liens soient à détruire(logique !!). En demandant un prompt avant chaque destruction automatique de liens, on évite ce genre de situation.


FabriqueTexteVC
Cette case autorise le génération automatique de deux fichiers:
- xxx.ind contient tous les noms de groupes en ASCII+CR
- xxx.key  contient tous les mots clefs en ASCII+CR

Cela permet à un programme qui en plus d'une aide contextuelle, possède une aide sur mot clef (comme un EDI de compilateur qui appelle directement l'aide d'une fonction par simple clique sur son nom)
Ces fichiers ne sont pas triés et xxx.key peut contenir des doublons. A vous d'en faire ce que vous souhaitez. Utiliser ces fichiers permet d'éviter le message classique de WinHelp "La rubrique d'aide n'existe pas".


Options Visual C++
Options/VisualC++

Pour plus d'informatiions, cliquez sur la zone qui vous intéresse.


AutorizeLienVC
Cette case permet de blocker la génération automatique du fichier include xxx.hm extrait du fichier resource du projet AppWizard quand on demande une génration complète(Fabrique/Fait Tout). C'est pratique quand on sait que les resources concernées n'ont pas été modifiées.

De plus tout AIDE n'étant pas liée à un projet Visual C++ doit désactiver l'édition des liens.


CHoixHID
Le programme différents type d'ID de resource (AFX, controle, dialogue..)
Pour ne pas toujours avoir le maximum de choix dans la sélection des ID, il est possible de filtrer certains types.
En prenant le choix "Tout", tous les identificateurs importés sont présents dans la combo box.
En sélectionant "Choix HID_, les check box situés en dessous permettent de définir le filtre. En général, il n'est pas utile de récuperer les ID du type AFX. Sauf si on veut supperposer une aide en français aux aides typiques déjà définies.


FichierIncludeMFC
L'emplacement du fichier afxhelp.hm est obligatoire pour avoir les identificateurs des MFC.


FichierIncludeVC
La sélection du fichier resource est obligatoire pour établir des liens avec un projet VisualC++. En effet MakHlp extrait le fichier xxx.hm à partir du fichier resource.h de AppStudio.


Menu Options projet
Edition des options d'un Projet

Pour plus d'informatiions, cliquez sur la zone qui vous intéresse.


ProjetNom
Nom du projet

Le nom de projet est obligatoire pour toute génration de code


ProjetChapitre
Chapitre

Les chapitres servent uniquement à la réalisation de votre projet, pour mieux vous organiser à trouver vos groupes.

Aucune influence sur le fichier .HLP.


ProjetInclude
Includes Externes

Il est possible d'inclure dans l'aide des fichiers includes externes pour des liens entre un programme et une aide.


ProjetContent
Groupe par defaut

Ce champ permet de spécifier la page d'index qui est choisie quand on demande l'index de l'aide à partir d'un programme


ProjetCopyright
Copyright

Ce champ permet d'afficher un Copyright personnel dans la fenêtre à propos de l'aide


ProjetErreur
Fichier Erreur

Les erreurs de compilation sont mises dans ce fichier


ProjetIcone
Nom fichier Icon

On indique dans ce champs le nom d'un fichier ICON (.ico) utilisé par l'aide


ProjetRtf
RTF Externes

Il est possible d'inclure dans l'aide des fichiers RTF d'une autre provenance. Si ces fichiers utilisent des includes, ceux-ci peuvent ètre spécificés dans le fenêtre adjacente.


ProjetTitre
Titre

C'est le titre qui est sur la fenêtre d'aide


ProjetVCVB
Visual C++ / Visual Basic

Permet de choisir le type d'aide contextuelle associée au projet d'aide


ProjetCDROM
Options Compression & Erreur

La case CDROM permet de spécifier la création d'un fichier optimisé pour CDROM
Le choix Compression permet d'indiquer le taux de compression des images (.BMP)
La case rapport autorise la création de messages d'erreur.
Le choix Warning permet de spécifier quelles types d'erreurs sont rapportées.


Projet Descriptif
Descriptif

Permet de mettre des notes concernant le projet, il n'a aucune influence sur le fonctionnement.


Projet Nom Répertoire
Nom répertoire

Ce champ permet de spécifier le répertoire où l'ensemble des fichiers sont générés.
Il est fortement conseillé d'utiliser ce champ pour ne pas à avoir les aides dans le même répertoire


Exemple Type
Exemple Type Principal

Sous Titre Normalisé

L'utilisation de l'option image sur ligne permet la ligne suivante. Quand cette option est cochée la bitmap est considéré comme un caractère.

 Choix 1 Popup	 Choix Fenetre 2

test+2TAB	BitMap aligné sur celle du dessus

Texte normal, il peut ètre collé à gauche , à droite ou centréSaut au mileu sur la fenetre exemple 2, c'est  vraiment un exemple complet avec un cadre autour du paragraphe

Texte indenté normal avec une barre verticale sur la gauche, le retrait de première ligne est 1cm

Ceci est un texte normal mais il possède l'attribut fixe, c'est à dire qu'il ne sera pas découpé lors du rétrécissement de la fenêtre.
Seul un return peut imposer un retour à la ligne.

Ceci est le début d'un texte avec la bitmap [image] en plein milieu d'une ligne de texte


Exemple Fenetre 1
Fenêtre 1 en Popup

Petite bitmap sans action associée


Exemple Fenetre 2
Exemple fenêtre 2

Exemple de son


Exemple Visual Basic

L'importation d'un projet Visual Basic est désormais automatique. Le répertoire exemple contient un projet visual basic "PROJET1.MAK" qui permet de démontrer la forme à donner à un programme.
Toute feuille ou tout controle (enfin presque tous), possède un champ nommé "HelpContextID" qui contient en général la valeur 0.
Quand cette valeur reste à 0, c'est la feuille déclarée dans le champ "content" dans "Options/Projet" qui est appelée par action de la touche F1
Quand cette valeur change et est différente de 0, à l'analyse du projet .MAK le champ correspondant est placé dans le fichier XXX.HM (évidemment uniquement quand on demande la création de ce fichier (soit "Fait Include" ou "Fait Tout" avec l'autorisation dans Options/Visual Basic)
Après modification du fichier XXX.HM, pour valider tout changement, il faut au moins une fois faire OK (ou Valider) dans le dialogue Options/Visual Basic. Alors seulement la modification sera visible dans le liste (combo box) qui propose les références.
Cette opération n'est pas automatique pour minimiser les risques d'erreurs (ce mode automatique a existé dans les premières bêta, mais après plusieurs pertes de toutes les références dans tous les topics par une erreur (type déplacement de répertoire), l'auteur a supprimé ce mode)


Générateur Lien Visual
Génération Fichier Include Visual

Cette option génère un fichier XXX.hm :

Projet Visual C++ à partir du fichier resource.h du projet. En utilisant les ID standard des MFC, les identificateurs de resources commencent par un préfix lié au type de resource :

Commandes:        	ID_,IDM_
Prompts :         	IDP_
Resources:	IDR_
Dialogues:        	IDD_
Frame Controles:  	IDW_

Le fichier généré est importé dans le programme et une page peut ètre liée à un identificateur. Par exemple si IDD_ABOUTBOX est lié à une page, quand on appuie sur la touche F1 à l'intérieur de cette boite de dialogue, l'aide apparait directement sur cette page (c'est l'utilité de l'aide contextuelle).

Et pour le Visual Basic:
par analyse du .MAK et des fichiers .FRM qui doivent être sauvés au format texte.


Générateur de RTF
Génération du fichier RTF

Le descriptif effectué dans le programme est sauvé dans un fichier au format RTF. Ce format est celui utilisé par le compilateur d'aide.


Génération du HPJ
Génération du fichier HPJ

Le fichier HPJ contient la description du projet aide. Il a la même fonction que le .mak (ou .prj) pour les langages C, C++ ou basic.
Il décrit les options, les répertoires, les fichiers includes, les fichiers bitmap et les fichiers RTF.


Générateur HLP
Génération du .HLP

Le fichier .HLP est crée à partir des fichiers .RTF et .HPJ
Le compilateur d'aide de hc31.exe livré avec le SDK 3.1 compile ces fichiers


Racourci clavier

Editer un groupe ou un sujet

En étant sur la fenêtre d'édition du projet
La touche Entrée ou Return permet d'éditer le sujet ou le groupe qui est actif (qui a le focus).

Editer une image .BMP

En étant sur la fenêtre d'édition d'un sujet Texte Image. Le curseur sur l'image (zone à droite de la zone de saisie)
Si vous cliquez sur le bouton de droite de la sourie, vous pouvez éditer l'image avec l'éditeur de votre choix.

Pour ajouter un éditeur d'image : voir Options/Outils

Montre/Cacher une image et le rappel du type de sujet

En étant sur la fenêtre d'édition du projet, zone de type de sujet.
Si vous cliquez sur le bouton de droite de la sourie, vous pouvez activer ou désactiver l'affichage des images (dans cette zone) et le rappel du type de sujet qui est affiché au debut de chaque sujet (paragraphe).

Visualiser .HLP du projet

En appuyant simultanement sur les touches ALT et F1 : vous pouvez visualiser le fichier .HLP du projet actuel.


Les générateurs

Index principal de MakHlp

Ce logiciel n'est pas gratuit !!
Merci de respecter le principe du Shareware.

S'enregistrer (Licence d'Utilisation)

 A quoi sert ce programme ??

 Comment créer une aide

 Les boites de dialogues du programme

 Les différents générateurs

 La génération d'include du Visual C++

 La Génération du fichier RTF

 La génération du HPJ

 La génération du .HLP

 Exemple Type

 Exemple Visual Basic

 Racourci clavier (commandes cachés)

 Futures extensions si demande

 Choisir le compilateur d'aide

 Basic Wizard

 VBX Wizard

 Nouveautés


Dialogue sujet

Index principal de MakHlp

Ce logiciel n'est pas gratuit !!
Merci de respecter le principe du Shareware.

S'enregistrer (Licence d'Utilisation)

 A quoi sert ce programme ??

 Comment créer une aide

 Les boites de dialogues du programme

 Attributs des fenêtres

 Choix du Type

 Edition de groupe

 Edition de sujet

 Types : Titre, Sous titre, Texte et Texte Indenté

 Type : Texte Image (BipMap) et possibilié Saut

 Types : Saut

 Voir Exemple d'utilisation

 Echange de sujet

 Options générales

 Options projet

 Options Visual C++

 Options Visual Basic

 Les différents générateurs

 Exemple Type

 Exemple Visual Basic

 Racourci clavier (commandes cachés)

 Futures extensions si demande

 Choisir le compilateur d'aide

 Basic Wizard

 VBX Wizard

 Nouveautés


Boite de dialogue

Index principal de MakHlp

Ce logiciel n'est pas gratuit !!
Merci de respecter le principe du Shareware.

S'enregistrer (Licence d'Utilisation)

 A quoi sert ce programme ??

 Comment créer une aide

 Les boites de dialogues du programme

 Choix des textes globaux

 Choix du Type de sujet

 Configuration des fenêtres

 Edition de groupe

 Edition de sujet

 Echange de sujet

 Options générales

 Options projet

 Options Visual C++

 Options Visual Basic

 Les différents générateurs

 Exemple Type

 Exemple Visual Basic

 Racourci clavier (commandes cachés)

 Futures extensions si demande

 Choisir le compilateur d'aide

 Basic Wizard

 VBX Wizard

 Nouveautés


Comment faire une aide

Index principal de MakHlp

Ce logiciel n'est pas gratuit !!
Merci de respecter le principe du Shareware.

S'enregistrer (Licence d'Utilisation)

 A quoi sert ce programme ??

 Comment créer une aide

 Les premiers pas dans MakHlp

 Réaliser une aide d'un projet Visual C++

 Réaliser une aide d'un projet Visual Basic

 Les boites de dialogues du programme

 Les différents générateurs

 Exemple Type

 Exemple Visual Basic

 Racourci clavier (commandes cachés)

 Futures extensions si demande

 Choisir le compilateur d'aide

 Basic Wizard

 VBX Wizard

 Nouveautés


Utilité de ce programme
A QUOI JE SERS ??

Makhlp fabrique les fichiers utiles pour créer une aide windows (c'est à dire le fichier .HLP). Pour cela il faut avoir les compilateurs d'aide livrés avec les outils de développement sous windows (le fichier  hc31.exe doit ètre dans un repertoire du PATH)
Si vous ne possèdez pas cet outil, vous pouvez le trouver sur :
3615 TEASER "HC31.ZIP"
ou sur diverses BBS Microsoft
Ex: 	Luxembourg (32) 2-7350045  (HCP.ZIP)
England (44) 734 270065.

Ces aides peuvents peuvent ètre utilisées par n'importe quel programme. Elles peuvents aussi ètre exécutées par "winhelp.exe".

Bien que ce programme puisse fabriquer une aide en général, il est plus spécialement écrit pour les utilisateurs du Visual C++ et Visual Basic, car il permet au programmeur de lier directement ses menus et fenetres visual pour avoir une aide contextuelle. (Pour C++:il faut demander l'aide contextuelle à la génération du projet dans AppWizard)

Voir :comment créer un aide

Voir :Exemple de création d'aide


Index général
 Sommaire principal
de l'aide de MakHlp

Ce logiciel n'est pas gratuit !!
Merci de respecter le principe du Shareware.

S'enregistrer (Licence d'Utilisation)

Catalogue Win Novation

 A quoi sert ce programme ??

 Comment créer une aide

 Les boites de dialogues du programme

 Les différents générateurs

 Exemple Type

 Exemple Visual Basic

 Racourci clavier (commandes cachés)

 Futures extensions si demande

 Choisir le compilateur d'aide

 Basic Wizard

 VBX Wizard

 Nouveautés


S'enregistrer
                        Enregistrement de MakHlp Ver 2.xx"
                       	      LICENCE d'UTILISATION

      Date :__________________________

       Nom :_________________________________________________

  Adresse:_________________________________________________
                _________________________________________________

  Format de disquette :  ( )3.5"         ( )5.25"

  320 F TTC pour la France et Dom-Tom (+ 20 Fraix de port et emballage)

  ( ) Chèque
  ( ) Carte bancaire	N° : _ _ _ _  _ _ _ _  _ _ _ _  _ _ _ _
Date d'expiration : _ _ / _ _
Signature

Merci de bien vouloir envoyer votre règlement à :

Win Novation Informatique
1107 Av. Jacques Cartier
44811 St Herblain-Cedex 01

Remarques et Suggestions :
_________________________________________________________
_________________________________________________________
_________________________________________________________
_________________________________________________________
_________________________________________________________

Comment avez-vous connu ce logiciel ?
_________________________________________________________


FENETRE PRINCIPALE

Ce programme est un shareware, il n'est pas gratuit.

Si vous l'utilisez, enregistrez vous !!!

S'enregistrer (Licence d'Utilisation)

 Menu de l'aide


Fenêtre d'édition
FENETRE D'EDITION

Ce programme est un shareware, il n'est pas gratuit.

Si vous l'utilisez, enregistrez vous !!!

S'enregistrer (Licence d'Utilisation)

 Menu de l'aide


A propos !!
Win Novation Informatique
1107 Av. Jacques Cartier
44811 St Herblain Cedex 01
Tél (16) 40 43 58 18 - Fax (16) 51 80 78 23
Compuserve ID : 100 410,745

Ce fichier d'aide a été réalisé
grâce au ShareWare MakHlp


Les premiers pas dans MakHlp

Notes importantes:
1) Pour ouvrir les exemples 1 à 8 et les compiler il faut absolument modifier dans le menu Option/Projet le "Nom de répertoire" en indiquant le réperoire DIDAC

2) Pour modifier la police de caractère ou la couleur de texte des sujets, il suffit de cliquer sur le bouton STYLE quand vous êtes en édition d'un sujet (Voir sur l'index de l'aide de Makhlp le choix "Les boîtes de dialogues .../Edition d'un sujet".

Vous pouvez visualiser les sources de chaque exemple, en ouvrant le fichier .EHE dans le répertoire ...\DIDAC

* groupe = feuille

Exemple 1 : projet d'un groupe*

Sujets traités : créer un nouveau projet se composant d'un groupe avec un titre et un texte, donner un nom et un titre au projet, choisir le groupe par defaut, spécifier un repertoir de travail, sauvegarde et compillation du projet puis visualisation du fichier .HLP

Exemple 2 : projet d'un groupe* avec deux couleurs de fond

Sujets traités : idem que l'exemple 1, déclaration du sujet Titre en "Non Scroll",configuration et création d'une fenêtre principale qui permet de donner un couleur de fond à la partie "Non Scroll" et une autre couleur à la partie mobile, sauvegarde et compillation du projet puis visualisation du fichier .HLP

Exemple 3 : projet de trois groupes*

Sujets traités : idem que l'exemple 2,création de deux autres groupes, utilisation du type de lien  "Saut" et "Popup" entre les 3 groupes (feuilles),sauvegarde et compillation du projet puis visualisation du fichier .HLP

Exemple 4 : projet à deux groupes* dans deux fenêtres

Sujets traités : créer deux groupes, le premier groupe est la fenêtre principal et il se compose d'un titre et d'un saut, le deuxième groupe s'affiche dans une deuxième fenêtre et il se compose d'un Titre et d'un texte.

Exemple 5 : projet utilisant des images (.BMP)

Sujets traités : créer deux groupes, utilisation des sujets de type Texte Image, utilisation du lien de type Son, sauvegarde et compillation du projet puis visualisation du fichier .HLP

Exemple 6 : changer de couleur de texte dans un paragraphe

Sujets traités : créer un groupe avec un titre et un paragraphe, le texte du pragraphe se compose de plusieurs sujets de type Texte avec des couleurs différentes.

Exemple 7 : utilisation des paramêtres "Bar vert", "Cadre" et "Fixe"

Exemple 8 : utilisation de "global saisie"

déclarer une chaine de caractères dans Projet/Global/Saisie qui déclenche une action, le programme met en évidence cette chaine (souligne et change la couleur) dans tout les sujets de votre projet sauf le sujet de type Saut.

Exemple d'aide EXCEL (merci à Mr RENAUD pour cet exemple)


Nouveautés

1) Copier/coller possible de topics entre deux projets ouverts

2) sélection multiple dans l'échange de sujets

3) Edition des topics ou des paragraphes par appuie sur touche ENTREE

4) Multiple contexte id vers le même topic

5) Visualisation des références non ratachées

6) nouvelle macro permettant d'executer une commande

7) Look 3D sur toute l'application

8) Taille de la fenêtre variable (la fenêtre des sujets s'agrandit)

9) Prévisualisation plus réaliste de l'aide lors de la saisie

10) Notion d'outil pour ouverture des bitmaps et .SHG

11) Chemin complet des fichiers BMP dans fichier .BAT de copie

12) Didactitiel dans l'aide

13) Gestion des aides 32 bits par appel de WINMM.DLL

14) Gestion de Visual Basic 4 pour aide contextuelle automatique

15) Nouveaux paramètrages pour les types de bords


Menu Fabrique Tout
Fabrique Tout

Ce choix permet la génération de toutes les sources utiles à la compilation du fichier .HLP


Charger dernier Fichier

Cette commande du menu permet de charger l'un des 4 derniers fichiers utilisés


Ouvrir un fichier

Ouvrir un fichier déjà existant


Menu Fichier Nouveau
Fichier Nouveau

Crée un nouveau projet


Menu Fichier Sauver
Sauver

Sauve le document ouvert


Menu fichier Sauver Sous
Sauver Sous

Sauve le document ouvert en proposant un autre nom


Menu  Configuration imprimante
Configuration Imprimante

Ce choix permet de configurer l'imprimante avant une impression.


Menu Fichier Quitter
Quitter

Quitte le programme. Si le document a été modifié, une fenêtre s'ouvre pour proposer la sauvegarde.


Bar d'outils
Barre d'outils (Tools Bar)

Permet de montrer ou de cacher la barre d'outils


Menu Vues Status Bar
Barre de status

Permet de cacher ou de montrer la barre de status


Menu test help
Test de l'aide

Ce choix permet de tester l'aide en cours de développement


Aide Contextuel
Aide Contextuelle

En appuyant sur ce bouton, on fait apparaitre le curseur d'aide contextuelle. En posant ce curseur sur un élément de menu ou une fenêtre, on obtient une aide sur ce qui est choisi.


Menu Index de l'aide

Ce choix du menu permet d'entrer directement sur l'index de l'aide.


Menu Utilisation de l'aide
Comment utiliser l'aide

Ce choix permet d'avoir accès à une aide expliquant comment utiliser une aide.


Export fichier RTF
Export RTF

Fabrique un fichier RTF propre, non utilisé par le programme.

Son utilité, il peut être importé par un traitement de texte.


Export fichier Txt

Fabrique un fichier .TXT, non utilisé par le programme.

Son utilité, il peut être importé par un traitement de texte.


Affiche ABout MakHlp
Aide/About MakHlp

Affiche des informations sur l'Editeur de MakHlp.

Affiche des informations sur l'Editeur de MakHlp.


Position à droite de la fenêtre
A droite Fen.

Place la sélection collée sur le bord droit du contrôle mère


Dialogue choix des fonts
Choix des fonts

Ce dialogue permet de choisir les types ,tailles et couleur des caractères


Selectioner Groupe
Permet de sélectionner le groupe qui va être affiché si l'action est un "Saut ou une "Popup".


Action Rien
Rien

Aucune action n'est déclenché.


Générateur Wizard VBX

Cette section intéresse seulement  les programmeurs avertis qui fabriques des fichiers .VBX
Le générateur analyse le fichier .VBX sélectionné et retrouve tous les controles qu'il contient (nom, propriétés, évènements). Cela permet de fabriquer le squelette d'aide complet pour un VBX
Pour l'instant, seul le préfix de génération est paramètrable.


Wizard Basic
Wizard Basic générateur

Introduction

Cette nouvelle version implémente la création automatique d'une aide Visual Basic en quelques opération seulement. Le programmeur doit seulement gèrer les nombres qu'il place dans les champs "HelpContextID" des feuilles ou descontroles de Visual Basic. En mettant une valeur différente de zéro, il indique une identificateur qui sera utilisé au niveau de MAKHLP.

Comment procéder

1) Ecrire des nombres positifs différents dans les champs "HelpContextID" des controles qui doivent donner une aide spécifique à leur fonction.

2) Sauver la feuille sous la forme TEXTE

3) Lancer MAKHLP
4) Ouvrir un nouveau projet (vide)
5) Choisir les options par défaut des différents types de paragraphe (optionnel)
6) Choisir le menu Projets/Basic Wizard/Génération Basic Wizard
7) Choisir le nom du projet BASIC ".MAK"
8) A ce niveau le générateur  remplit automatiquement:
- le document
- le nom du projet
- le repertoire destination
- le type de projet (Visual Basic)
- le nom du projet .MAK est remplit dans Option/Visual Basic
- le fichier .HM est fabriqué automatique cette fois ci
9) On peut déjà fabriquer l'aide en cliquanf sur le bouton champignon

Il suffit alors de faire "Fait Tout " (ou build All), et vous avez immédiatement une aide pour votre programme. Il vous reste à remplir ou modifier les phrases existantes.